课堂助手 v4.0 — 使用指南（简体中文）
© 2026 Mitchell Papish
Windows 离线课堂工具 • 支持英语 / 简体中文切换

一、安装或免安装运行

先从系统托盘菜单选择“退出”，关闭旧版。运行 ClassroomCompanion-v4.0-Setup.exe 安装；也可解压 ClassroomCompanion-v4.0-Portable.zip，然后打开 ClassroomCompanion.exe。不要直接在 ZIP 内运行程序，请保留同目录的 languages 文件夹。安装范围为当前用户，无需 PowerPoint。

适用目标：Windows 11 和 .NET Framework 4.8。课堂工具不需要账号或网络。软件包尚未签名，学校电脑的部署策略可能需要 IT 人员协助。旧版发布包单独保留。

数据默认保存在 %LOCALAPPDATA%\ClassroomCompanion。v4.0 沿用 v3.x 数据格式并保留记录、增加设置。切换版本前建议导出完整备份。首次升级 v1/v2 数据时会生成 before-v3-migration 恢复备份。不要同时用两个版本操作同一数据文件夹。

首次使用新数据文件夹会出现虚构的示例学生。正式上课前请建立自己的班级。

二、工具栏与显示器

工具栏置于普通应用窗口上方，可配合正常打开的 PowerPoint、浏览器、PDF 和视频使用。拖动圆点手柄移动工具栏；靠近屏幕边缘松开可吸附。左右边缘自动竖排，上下边缘自动横排，可沿边缘放在任意位置。v4.0 会同时参考松手时的鼠标位置，修复工具栏部分移出右侧屏幕时未能吸附竖排的问题。

空闲两秒后工具栏默认淡到 25% 不透明度。鼠标移入显示，点击启动工具。触摸时第一次点击显示，第二次点击启动。“−”折叠；“×”仅隐藏工具栏。可通过托盘或 Ctrl+Alt+0 恢复。设置→外观可调整透明度、大小、边缘自动隐藏、仅图标模式和按钮顺序。新增“隐藏学生窗”按钮，折叠时也可使用。

“隐藏学生窗”会隐藏学生端活动、清除待显示积分通知并停止积分音效；正在运行的计时器会暂停，媒体停止播放。正在抽选的点名窗口会关闭，已记入历史的抽选仍保留。分组、积分总览、座位和白板窗口隐藏但不删除保存的数据。重新打开相应工具可继续或重新显示。隐藏白板的未保存内容仅保留在内存中，退出前仍需保存。此按钮不同于工具栏的“×”。

设置→常规可选教师和学生显示器。“连接第二个显示器时自动用于学生视图”默认开启。若学生视图目前使用教师屏幕，或所选屏幕不可用，连接另一显示器后会自动选择非教师屏幕。已有的有效独立学生屏幕选择会保留。如需故意在同一显示器显示两种视图，可关闭此选项。

连接新显示器后，可见活动会尽可能移动到学生屏幕；教师私密面板隐藏，需主动重新打开。断开显示器或无法安全恢复时，活动隐藏、计时器暂停。镜像模式无法保护隐私，两屏显示相同内容；打开记录前请查看共享屏幕提示。独占全屏或受保护软件可能覆盖悬浮窗口，可尝试窗口化或无边框模式。

快捷键：Ctrl+Alt+1 点名；2 计时器；3 白板；4 分组；5 积分；6 座位。其他应用可能占用快捷键，仍可使用托盘。

三、班级、导入与考勤

在“班级”中建立、选择班级并管理学生。支持粘贴名单、纯文本、CSV 和 Excel（.xlsx）；Excel 从第一张工作表的第一列读取姓名。导入前先预览并处理警告。已移除仅用于早期示例的 No Hands 专用导入。

课表支持每周课程和 A/B 周；在常规设置中设定 A 周星期一。建议班级不会阻止手动选择。抽选、分组和积分前请标记缺席：缺席学生保留在已保存分组、座位中，但不参加个人抽选、新分组生成或分组积分接收。没有出席成员的组不会参加分组抽选。

四、点名与分组抽选

点击工具栏“点名”立即按已保存设置抽选。旁边箭头打开教师端设置：学生/分组、转盘/姓名闪选、每人轮到一次/完全随机、音效和自动隐藏。分组模式使用当前班级的活动分组。

姓名闪选约 0.5 秒后停止；转盘动画较长。转盘文字沿扇区排列并按长姓名缩放，完整结果在下方显示。名单很多时文字会较小。抽选期间重复点击不会新增抽选。

“每人都有机会”模式会跨天、重启保存进度，不会每天自动清零。每班的学生和分组分别记录轮次。全部符合条件的对象都选完后，下次开始新轮次。成员或出勤变化会重置受影响的轮次，但保留日期历史。完全随机模式也记录历史。教师菜单的历史区显示近期抽选。“清除抽选记录并重新开始”经确认后清除当前班级、当前模式的历史及轮次，其他班级和模式不受影响。

抽选音效包括离线合成掌声、铃声、和弦、系统音和自定义音频。打开“音效”，选择、试听并调整音量。自定义文件复制到资源文件夹并随完整备份保存。支持格式取决于 Windows 解码器，WAV 通常最可靠。

五、自动隐藏（v4.0 新增）

点名、计时器、分组分别有独立隐藏延迟。输入 0–3600 的整数秒并保存；0 表示关闭自动隐藏，也是默认值。在各工具教师端的“自动隐藏”区或设置→活动中调整。

点名从最终结果出现后开始计时，不占用动画时间；分组从向学生显示时开始；计时器只在倒计时结束后开始，不会在倒计时仍运行时自动隐藏。延迟到期后短暂淡出并隐藏。设置和编辑仍在教师端。隐藏时停止活动音频。开始新的抽选，或重置、重启计时器，会取消原有隐藏倒计时。

六、计时器

点击“计时器”，选择 1、2、5、10 分钟或自定义时长后立即显示并开始。重新打开教师控制可暂停/继续、重置、关闭。替换正在运行的计时器会先确认。

“外观和音频”提供角落、弹窗、全屏模式；海洋、森林、夜空主题；独立选择背景图片/视频、背景音乐和结束提示音。视频声音有单独开关和音量。内置柔和离线音乐及铃声、和弦、脉冲结束音。静音会关闭计时器音频。切换显示模式不改变倒计时；使用截止时间计算，电脑休眠或界面更新延迟不会简单延长计时。

选择内置主题会清除自定义视觉背景。文件复制到资源中，播放支持取决于本机解码器。“隐藏学生窗”暂停计时器；重新打开计时控制可继续。结束后自动隐藏时，可正常选择下一个时长启动。

七、积分与音效

积分采用紧凑姓名卡片。用“卡片大小”滑块调整，或点“适应全班”；人数较多可最大化教师窗口。极大班级在最小尺寸下仍可能需要滚动。展开分组活动积分可查看组名、成员和分组加减分。

设置每次分值、类别后使用 +/−。给组加分时，该组活动分数增加一次，每位出席成员的个人分数也增加。接收者和姓名在授分当时保存快照，之后改名、换组不会重写历史。加载组预设会开始新的分组活动分数。

设置→活动可控制学生端积分通知、持续时间和音效。启用音效后，加分和扣分分别选择和弦、铃声、短蜂鸣声或无；默认加分为和弦、扣分为短蜂鸣声。原来关闭音效的设置保持关闭。可分别试听、调整“积分音效音量”，然后保存。即使关闭视觉积分通知，也可播放积分声音。快速通知会排队且不抢焦点。撤销会取消未显示的通知，或显示更正；更正按反向分值播放对应音效。

“显示学生总分/显示分组分数”向学生展示汇总。属性和详细历史默认只在教师端。撤销可恢复最近一次授分或重置。重置总分保留历史。清除历史默认仅当前班且保留总分，可改为所有班或同时清零；清除前先保存 before-history-clear-….ccbackup 完整备份。普通撤销无法恢复清空的历史，需要导入备份。保留的总分成为期初余额。

八、分组、规则和技能属性

可按组数或目标组大小生成。分组卡片显示学生、人数、缺席。拖动学生或用“移动到组”菜单调整，可内联改组名。重新打乱前可用锁图标固定位置；移动前需解锁。手动移动违反规则时必须明确覆盖；人数不均会提示，但不阻止有意安排。

在可搜索的规则编辑器选择多名学生，再选“保持同组”或“保持分开”。同组要求全部所选学生在一组；分开要求每一对都分离。已有规则可编辑/删除；生成前提示矛盾或不可能的条件。

“技能”提供全班评分/类别网格、批量赋值和 Excel 矩形粘贴。新评分默认 1–5；缺失值保持未评分。可同时选择多个分组属性，各自选择水平/类别混合或相近。混合数值尽量让各组平均水平接近，相近模式让组内成员接近；类别目标分别为分散或集中。字段归一化后等权，缺失值不产生属性分数。出勤、均衡人数、规则和锁定为硬约束。

活动分组跨次保存，可保存多个命名预设。加载是复制，之后修改活动分组不会悄悄覆盖预设。加载时会提示已移除学生。清空活动分组不删除预设、座位或历史积分，并提供立即撤销。颜色自动分配，在设置→外观→分组颜色中统一调整。点击“向学生显示”打开公开分组。

九、座位与收藏

座位编辑在教师屏幕打开。支持桌组、圆形、U 形和传统排座。4 行、每行 5 座会生成面向黑板的 20 个独立座位。可设置间距、过道、缩放、适应窗口、居中及家具大小。拖动圆点手柄移动家具；拖动姓名交换座位，右键分配或清空。家具选项调整类型、座位数和旋转。

收藏可保存通用空布局或带学生的班级安排，支持保存、另存、加载、重命名和删除。加载后独立编辑，只有明确保存才更新收藏。替换未保存内容会警告；已移除学生的座位留空。“向学生显示”发布只读快照，之后改动需“更新显示”；隐藏学生窗不删除已保存方案。

十、白板

可打开空白板，或截取指定显示器后在静态截图上批注。截图前隐藏助手控制；受保护内容可能无法捕获，可改用空白板。支持画笔、荧光笔、橡皮、文字、撤销/重做、PNG 导出和可编辑白板保存。控制在教师端，绘画在活动画布。退出前保存。此版不提供实时透明屏幕绘画。

十一、备份、位置与恢复

设置→备份导出一个带版本的 .ccbackup，包含班级、分组预设、积分、抽选记录与进度、设置、白板和媒体资源。导入前先验证、预览并备份原数据。导入替换工作区，不是合并。可自行将备份复制到其他磁盘；本软件不提供云同步。

可用 --data "D:\MyClassroomData" 指定可写文件夹，或在程序旁放置 data-location.txt。更换位置前退出并通过备份转移。免安装程序默认仍用当前用户数据位置，不代表数据自动跟随程序。

十二、关于与测试范围

设置→关于显示 Book & Spark 图标、v4.0 和 © 2026 Mitchell Papish。已加入创作者提供的简介。图标已嵌入程序、普通窗口、任务栏、托盘及安装程序/快捷方式。Windows 可能缓存旧快捷方式图标，必要时从新版安装重新建立快捷方式。

自动检查使用虚构数据，覆盖双语、保存和主要课堂流程。真实投影仪、混合缩放、触控笔、扬声器、自定义解码器及干净 Windows 的安装/卸载仍需现场测试。此版不含 Mac、云同步及商业授权/支付功能。

点名功能优化 — v4.0 更新

“点名”旁新增“学生 / 分组”按钮，显示当前模式。点击一次切换，再点“点名”即抽选。旁边箭头仍可打开完整设置。等待或进行抽选时忽略模式切换，避免改变正在抽选的结果。学生和分组分别保留各自的不重复轮次。

教师与学生屏幕独立时，结果揭晓后在教师屏幕弹出四秒提示，显示姓名或组名及出席成员，不抢键盘焦点。单屏或镜像模式自动不显示此提示。该提示属于教师私密窗口，显示器恢复时会隐藏。

出席学生的积分卡新增小 ◎ 按钮：“使用当前动画抽选此学生”。它切换到学生模式，并使用已保存的转盘或闪选动画，让此学生成为结果。学生端呈现与普通抽选一致。缺席学生无法指定。此操作覆盖随机/不重复选择规则，将学生标为本轮已选，并在教师私密历史标记“教师指定”。若指定本轮已选学生，允许有意重复，其他已选记录保留。整轮完成后仍按通常规则开始新一轮。该操作不改变积分。抽选期间重复点击会忽略。

关于创作者
Mitchell 拥有二十余年的课堂教学经验，也是一位终身学习者。最近，他开始尝试借助 AI 辅助编程，制作实用工具，帮助教育工作者更聪明地工作，而非更加辛苦。
